home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / MID / Util / MIDIEX.sea / Midiex / MidiEx Mac Docs next >
Text File  |  1990-10-27  |  12KB  |  211 lines
  1. -------------------------------------------------------------------  
  2.   MidiEx Mac © Copyright 1989 Thomas W. Inskip 
  3.    © 1986 Think Technologies, Inc. Certain portions of this program are 
  4. Copyrighted by Think Technologies, Inc. 
  5.    © 1987 Altech Systems. Certain portions of this program are 
  6. Copyrighted by Altech Systems. 
  7. ------------------------------------------------------------------- 
  8.                                           About MidiEx Mac 
  9.  
  10.   MidiEx Mac is a full featured universal patch librarian with MIDI 
  11. Exclusive capabilities and sample dump standard support. MidiEx Mac is not 
  12. free, and it is sold under the Macintosh™ Honor System (Shareware). You 
  13. may distribute this program freely to anyone who may have a use for it. If 
  14. you are not interested in registering, please erase all the copies of MidiEx 
  15. Mac you have, or better, give them to someone else along with this 
  16. document. The registration price is $25. If you think about how much you 
  17. paid for your computer and MIDI equipment, you'll realize this is a very 
  18. small price to pay for it, and you will be helping the development of 
  19. quality Macintosh™ shareware programs. 
  20.    Please report me any bugs you find. 
  21.    For registration, comments and suggestions please contact me: 
  22.            
  23.                                     Thomas W. Inskip 
  24.                                     6504 Democracy Blvd. 
  25.                                     Bethesda, MD 20817 
  26.                                     (301) 530-0866 
  27.  
  28. ------------------------------------------------------------------- 
  29.                                        About MIDI Exclusive 
  30.  
  31.    MIDI Exclusive is a format supported in most computers (except the Mac, 
  32. until now), which allows users to share MIDI System Exclusive information 
  33. such as patches, performance set ups, or any other information used by 
  34. MIDI controlled equipment, with the exception of real-time sequences. It 
  35. consists simply of the information that has to be sent to the synthesizer, 
  36. drum machine, or whatever and allows you to share MIDI Exclusive files 
  37. with other MIDI users regardless of which computer they use. 
  38. ------------------------------------------------------------------- 
  39.                                        About Sample Dumps 
  40.  
  41.    The Sample Dump Standard is a handshaking protocol used to transmit 
  42. sound sample data between samplers and computers. This protocol is used 
  43. to minimize the possibility of transmission errors, which are more more 
  44. than possible due to the sometimes great length of samples. The sample 
  45. files created with MidiEx Mac can be treated as MIDI Exclusive files since 
  46. they consist only of the data that needs to be sent to a sampler (this is the 
  47. dump header, and the data packets). 
  48. ------------------------------------------------------------------- 
  49.                                       How to use MidiEx Mac 
  50.  
  51. • The MidiEx window contains the name of the currently open banks in the    
  52.    left portion, and the name of the message (discussed below)                      
  53.    corresponding to that bank in the right portion. The banks can be selected  
  54.    by clicking and dragging. Commands chosen from a menu have effect on      
  55.    all selected banks. The MidiEx window can be dragged to any position in     
  56.    the screen. Clicking in the close box has the same effect as choosing         
  57.    Quit from the File menu. Notice that "empty" does not have the same          
  58.    meaning as "Untitled"; empty banks have no data whatsoever, while           
  59.    untitled banks have data, but the user hasn't provided a name for them. 
  60.  
  61. • The File menu contains the same items that most Macintosh™                    
  62.    applications do.  
  63.  
  64. - New has the same effect than choosing Capture Dump from the MidiEx        
  65.    menu (discussed below).  
  66.  
  67. - Open opens any file of type TEXT (usual format for MIDI Exclusive files). 
  68.  
  69. - Open Other opens any file of any type, which is useful for opening non        
  70.    TEXT files (such as Master Tracks Pro* SYSEX files). This does not mean    
  71.    that the file is suitable for MIDI Exclusive purposes, but it will work in    
  72.    most cases.  
  73.  
  74. - Get Info displays a window which contains the bank name, the size of the  
  75.    dump in bytes, and the manufacturer of the machine from which the dump  
  76.    was received. 
  77.  
  78. - Close, Save, Save As, and Quit have the standard meaning. 
  79.  
  80. • The Edit menu is not supported by MidiEx Mac since you don't access          
  81.    individual elements in a dump. It's there for the use of Desk Accessories. 
  82.  
  83. • The MidiEx menu contains the commands for MIDI communication.  
  84.  
  85. -  Capture  Dump presents a window for receiving MIDI Exclusive data.          
  86.     Clicking on Start Capture tells the program to start storing the data. If    
  87.     you haven't specified a Message for the bank you are trying to capture,     
  88.     you will have to  manually tell the synthesizer, drum machine, or             
  89.     whatever to send the data (most machines have a manual dump request     
  90.     feature). If you have specified a message for that bank, the program will  
  91.     request the dump for you. Once MidiEx Mac is capturing data, the               
  92.     Transmission Progress box will start to get full. Click on Stop Capture    
  93.     when you see that the transmission has stopped. Once captured the data, 
  94.     clicking on Start Capture again will dispose of the dump and re-attempt  
  95.     the  capture again, clicking on Cancel disposes of it, and clicking OK       
  96.     will present a box asking you for a bank name (if you don't specify a  
  97.     name it will be stored as "Untitled"). If you have selected more than one   
  98.     bank, the process will be repeated for the next selected bank. 
  99.  
  100. - Send Dump sends the data stored in the selected banks through the MIDI     
  101.    line.
  102.  
  103. - Capture Sample will open a dialog window asking for a sample number       
  104.    and a MIDI channel on which to receive it. If you specify both of them,       
  105.    the sample will be automatically requested, otherwise you will have to    
  106.    do a manual request from the sampler (If you use an Akai S-900 you will   
  107.    always have to specify 1 as the MIDI channel, or do the request 
  108.    manually)   
  109.    After you clicked OK, another dialog box will open asking for a file to  
  110.    which to save the sample, and after this, another window will appear,       
  111.    displaying the sample length in bytes, how many bytes have been  
  112.    received, the file to which the data is being saved, the number of   
  113.    non-corrected errors, and the estimated time left. This window will be  
  114.    updated every few seconds. The sample dump can be aborted at any time 
  115.    by typing a period ( . ) while holding down the command key. 
  116.  
  117. - Send Sample  sends a sample file over the MIDI line. It will first  
  118.    open a dialog box asking for a sample file from which to send the data. 
  119.    once selected a file it will open another dialog box asking for which  
  120.    sample number should the data be sent as, and on which MIDI channel. If  
  121.    you don't specify either the channel or the sample number, the data will 
  122.    be sent over the same channel over which it was originally received, and 
  123.    with the same sample number. After this, a window displaying the  
  124.    number of bytes sent, the length of the sample in bytes, the estimated  
  125.    time left, and the number of non-corrected errors will be opened. This  
  126.    window will be updated every few seconds. The sample dump can be 
  127.    aborted at any time by typing a period ( . ) while holding down the  
  128.    command key. 
  129.  
  130. - Midi SetUp lets you select which serial port you have your MIDI interface  
  131.     connected to, and which speed does it work on (0.5, 1, or 2MHz). 
  132.  
  133. • The Message menu contains the dump request messages for various            
  134.    synthesizers, and the commands to create new ones, or destroy old ones.   
  135.    Dump request messages are little System Exclusive messages the             
  136.    computer sends to the synthesizer (or whatever) to ask for a dump (such   
  137.    as patches, performance settings, etc.). If MidiEx Mac doesn't have a          
  138.    dump request message for one of your machines, you can add one; they       
  139.    are usually listed in the manuals, and if not, you can get them from  the    
  140.    manufacturer. You can also destroy messages that you know you are not   
  141.    going to use.  
  142.  
  143. - New Message opens a window in which you can enter the new message (in  
  144.    hexadecimal format), and the message name. Once you have added the        
  145.    message, it will be always listed in the Message menu. You may also  
  146.    include "parameters" in your dump request messages. Parameters are 
  147.    made of two characters; the first one is a question mark ( ? ), and the 
  148.    second one may be any other printable character. If you use parameters,  
  149.    MidiEx Mac will ask you for their value before requesting a dump. This 
  150.    is specially useful if you have several messages which only differ in one 
  151.    or two bytes (such as in the MIDI channel value); you can specify these      
  152.    bytes by using a parameter. An example of a valid request message with  
  153.    parameters is: F043?C005F?*F7 . 
  154.  
  155. - Delete Message  erases (for ever) the selected message (the one with a     
  156.    check mark).  
  157.  
  158. - To assign a message to a bank, first select a bank (or banks), and then a    
  159.    message from the Message menu. That way, when you capture a dump to     
  160.    be stored in that bank you won't have to request it manually. If you            
  161.    select "None" as a message, or select the wrong message for a bank (you   
  162.    don't have the machine it belongs to), you'll have do do the request             
  163.    manually. 
  164. ------------------------------------------------------------------- 
  165.                                              Special notes 
  166.  
  167. • The sum of the lengths of all currently open banks can't exceed 2048 K or  
  168.    the total amount of free memory, whichever is less. 
  169.  
  170. • To run the program under MultiFinder, you will have to change the amount  
  171.    of memory used by the program, which is preset to 2048 K. 
  172.  
  173. • If you upload the files created with MidiEx Mac to a Bulletin Board             
  174.    Service, upload them with a binary format (such as XMODEM), but not Mac  
  175.    Binary, which writes Finder related information to the header which         
  176.    can't be read by other computers. Always make sure Mac Binary is turned   
  177.    off. 
  178.  
  179. • Sample dump files created with MidiEx Mac can be treated the same than 
  180.    MIDI Exclusive files, because they consist only of the data that needs to 
  181.    be sent to the sampler (dump header and data packets). This means that  
  182.    they can be shared with other computers. You could also open them with 
  183.    the Open Other option from the File menu and transmit them then with  
  184.    the Send Dump option, but there will be no error detection or correction. 
  185.  
  186. • This version of MidiEx Mac has new Icons, so If you have any older 
  187.    versions of the program, replace them with this one, and boot the 
  188.    disk(s) while holding down the Option and Command keys and answer
  189.    yes to update the desktop file. 
  190. ------------------------------------------------------------------- 
  191.    Macintosh is a ™ of Apple Computer, Inc. 
  192.    * Master Tracks Pro is a ™ of Passport Designs, Inc. 
  193. ------------------------------------------------------------------- 
  194.    Thanks to Mike Rivers, James Avery, John Holland, Lisa Beal,  
  195. Mike Sucher, and everybody at the Washington MIDI Users' Group.  
  196. ------------------------------------------------------------------- 
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.